home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / hwgraph.inv.z / hwgraph.inv
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhwwwwggggrrrraaaapppphhhh....iiiinnnnvvvv((((DDDD3333XXXX))))                                              hhhhwwwwggggrrrraaaapppphhhh....iiiinnnnvvvv((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh_...._iiii_nnnn_vvvv_:::: device_inventory_add, device_inventory_get_next,
  10.      device_controller_num_get, device_controller_num_set - device inventory
  11.      information
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////hhhhwwwwggggrrrraaaapppphhhh....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddddddiiii....hhhh>>>>
  17.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////iiiinnnnvvvveeeennnntttt....hhhh>>>>
  18.  
  19.      vvvvooooiiiidddd
  20.      ddddeeeevvvviiiicccceeee____iiiinnnnvvvveeeennnnttttoooorrrryyyy____aaaadddddddd((((ddddeeeevvvv____tttt _d_e_v_i_c_e,,,,
  21.                           iiiinnnntttt _c_l_a_s_s,,,,
  22.                           iiiinnnntttt _t_y_p_e,,,,
  23.                           mmmmaaaajjjjoooorrrr____tttt _c_t_l_r,,,,
  24.                           mmmmiiiinnnnoooorrrr____tttt _u_n_i_t,,,,
  25.                           iiiinnnntttt _s_t_a_t_e))));;;;
  26.  
  27.      iiiinnnnvvvveeeennnnttttoooorrrryyyy____tttt ****
  28.      ddddeeeevvvviiiicccceeee____iiiinnnnvvvveeeennnnttttoooorrrryyyy____ggggeeeetttt____nnnneeeexxxxtttt((((ddddeeeevvvv____tttt _d_e_v_i_c_e,,,, iiiinnnnvvvvppppllllaaaacccceeee____tttt **** _p_l_a_c_e))));;;;
  29.  
  30.      vvvvooooiiiidddd
  31.      ddddeeeevvvviiiicccceeee____ccccoooonnnnttttrrrroooolllllllleeeerrrr____nnnnuuuummmm____sssseeeetttt((((ddddeeeevvvv____tttt _d_e_v_i_c_e,,,, iiiinnnntttt _c_t_l_r))));;;;
  32.  
  33.      iiiinnnntttt
  34.      ddddeeeevvvviiiicccceeee____ccccoooonnnnttttrrrroooolllllllleeeerrrr____nnnnuuuummmm____ggggeeeetttt((((ddddeeeevvvv____tttt _d_e_v_i_c_e))));;;;
  35.  
  36.    AAAArrrrgggguuuummmmeeeennnnttttssss
  37.      _c_l_a_s_s       Inventory class to assign, from sys/invent.h.
  38.  
  39.      _c_t_l_r        Controller sequence number to assign.
  40.  
  41.      _d_e_v_i_c_e      Vertex handle of a device vertex.
  42.  
  43.      _p_l_a_c_e       Address of a variable to hold the current position in a scan
  44.                  of inventory records.
  45.  
  46.      _s_t_a_t_e       Arbitrary device state to assign.
  47.  
  48.      _t_y_p_e        Inventory device type to assign, from sys/invent.h.
  49.  
  50.      _u_n_i_t        Device unit number to assign.
  51.  
  52. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  53.      These functions manage the hardware inventory information.  In previous
  54.      releases of IRIX, the hardware inventory as reported by _h_i_n_v(1) and
  55.      _g_e_t_i_n_v_e_n_t(3) was maintained as a table in kernel memory.  Now the same
  56.      information is distributed throughout the hwgraph.  After creating a
  57.      device vertex as described in _h_w_g_r_a_p_h._d_e_v(D3X), the driver can attach
  58.      inventory information to the new vertex using _d_e_v_i_c_e__i_n_v_e_n_t_o_r_y__a_d_d().
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhwwwwggggrrrraaaapppphhhh....iiiinnnnvvvv((((DDDD3333XXXX))))                                              hhhhwwwwggggrrrraaaapppphhhh....iiiinnnnvvvv((((DDDD3333XXXX))))
  71.  
  72.  
  73.  
  74.      Normally only a single inventory record is attached to a vertex, but
  75.      multiple records are supported.  To read the first or all inventory
  76.      records call _d_e_v_i_c_e__i_n_v_e_n_t_o_r_y__g_e_t__n_e_x_t().  Initially the variable
  77.      addressed by _p_l_a_c_e should contain NULL to indicate "first."  The first
  78.      inventory record is returned (if any exist), and the position is noted.
  79.      Subsequent calls return further records if they exist.
  80.  
  81.      To read out the controller number from the first or only inventory
  82.      record, call _d_e_v_i_c_e__c_o_n_t_r_o_l_l_e_r__n_u_m__g_e_t().  This is the means of
  83.      discovering the controller number assigned by the _i_o_c_o_n_f_i_g(1) program.
  84.  
  85. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  86.      _d_e_v_i_c_e__i_n_v_e_n_t_o_r_y__g_e_t__n_e_x_t() returns NULL when no (further) inventory
  87.      record exists.
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      hinv(1), ioconfig(1), getinvent(3), hwgraph.dev(D3X), hwgraph.intro(D4X).
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.